The *Common Libraries* folder
=============================

Each VHDL project has a folder called *Common Libraries*. This is where reusable libraries go. By default, the STD and IEEE libraries are added to this folder.

Which files should be in *Common Libraries* ?
---------------------------------------------

Files in this folder are reusable libraries: either vendor libraries, third party IP libraries or your own reusable libraries.
While you work on your project, you don't want to edit the files in the *Common Libraries*, but you need them to compile your project.

How to add files to *Common Libraries* ?
----------------------------------------

Locate a folder with VHDL files on your file system (with Windows Explorer) and drag them to the *Common Libraries* folder.
Assign a library name to this folder: right-click on the folder name and select *Library Mapping > New Library..*

How is *Common Libraries* different from another folder ?
---------------------------------------------------------

* *Common Libraries* is a _virtual_ folder. This means that it is not a real folder in the project directory and it can only contain references to folder on your file system.

* Files in *Common Libraries* are supposed to be error free. Sigasi will not mark errors or warnings in these files.

* Files in *Common Libraries* are supposed to be pre-compiled. If you tell Sigasi to compile your project using an external compiler, the Common Libraries are skipped. You need to pre-compile them yourself and let your compiler know where the compiled libraries are. For ModelSim, you can use the "modelsim.ini" file for this.

What if I broke my *Common Libraries* folder?
---------------------------------------------

If you have modified the Common Libraries folder, you can always *revert* it
back to the original state. Right-click on your project in the explorer view
and apply menu-entry *Library Mapping > Reset Library Mapping*.

More info on http://www.sigasi.com/manual/libraries#libraries-common
